home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / srdisk12.zip / SRDISK.DOC < prev    next >
Text File  |  1991-10-04  |  7KB  |  182 lines
  1.  
  2.                     ReSizeable RAMDisk version 1.20
  3.                           for XMS memory only
  4.  
  5.                                  Author
  6.                              Marko Kohtala
  7.  
  8.                              PUBLIC DOMAIN
  9.  
  10.  
  11. No rights reserved. All parts of this product may be reproduced,
  12. stored in a retrieval system, or transmitted by any means, electronic,
  13. mechanical, protocopying, recording, or otherwise, without written
  14. permission from the author. No patent liability is assumed with respect
  15. to the use of the information contained herein. While every precaution
  16. has been taken in the preparation of this product, THE AUTHOR ASSUMES NO
  17. RESPONSIBILITY FOR ERRORS OR OMISSIONS. NEITHER IS ANY LIABILITY ASSUMED
  18. FOR DAMAGES RESULTING FROM THE USE OF THE PRODUCT DOCUMENTED HEREIN.
  19.  
  20.  
  21.  
  22. CONTENTS
  23.  
  24.   1. Publishing purpose, features included and recognised missing
  25.   2. Files in this release
  26.   3. Usage
  27.   4. Technical data for further development
  28.   5. Last words
  29.  
  30.  
  31.  
  32.     1. PUBLISHING PURPOSE, FEATURES INCLUDED AND RECOGNISED MISSING
  33.  
  34. This RAM disk driver is published in the hope we will get a really good
  35. RAM disk that is entirely public domain. I do not intend to make it all
  36. out myself but rather hope there is out there someone who is willing to
  37. participate in my work.
  38.  
  39. This RAM disk currently supports the following features:
  40.  
  41.   * XMS (Extended memory on 286 and up with HIMEM) support - no other
  42.     memory supported - yet
  43.   * Resizeable/removable - destructive
  44.   * Possible sizes from few Kbytes to 32M (provided you have enough
  45.     memory, of course)
  46.   * Configurable
  47.       - sector size
  48.       - cluster size
  49.       - root directory entry count
  50.       - number of FATs
  51.   * Predefined DOS disk like formats
  52.   * Write protection
  53.   * Compatible with DOS versions from 2.00 to 5.x
  54.     (tested only with DOS 5.0)
  55.   * Stores last format time in volume label
  56.  
  57. What I would like to see added:
  58.  
  59.   * Resizing of the disk without loosing disk contents
  60.   * EMS support
  61.   * UMB support
  62.   * Bank-Switch memory support ("The Last Byte" by Key Software)
  63.   * Low memory support
  64.   * Any combinations of those above (Bank-Switch+XMS/EMS mostly)
  65.  
  66.  
  67.  
  68.                         2. FILES IN THIS RELEASE
  69.  
  70. The following material is distributed in this release:
  71.  
  72.         SRDISK.DOC      this document
  73.         SRDISK.C        disk formatter source code for Turbo C++ 1.0
  74.         RDISK.ASM       device driver source code for XMS
  75.         RDISK.SYS       compiled device driver
  76.         SRDISK.EXE      compiled formatter program for the RAM disk
  77.  
  78.  
  79.  
  80.                                 3. USAGE
  81.  
  82. To use the RAM disk, you must have the device driver installed at boot
  83. time. This can be done by copying the RDISK.SYS to the root directory of
  84. your boot disk and including the line
  85.  
  86.         DEVICE=RDISK.SYS
  87.  
  88. to your CONFIG.SYS file.
  89.  
  90. After this change, when you boot your machine you should see a sign-on
  91. message close like "ReSizeable RAMDisk version x.xx virtual drive d:"
  92. without any annoying error messages.
  93.  
  94. If you see error messages, you may have forgotten to install the XMS
  95. driver (eg. HIMEM.SYS) prior to the RDISK.SYS, or you have improper DOS
  96. version or something. Try to fix the problem. If you fail... sorry.
  97.  
  98. If no errors are detected, you have no ramdisk. If you try to use that
  99. disk mentioned on the sign-on message, you'll notice the disk is not
  100. ready. That is because the ramdisk has not been enabled yet. For that
  101. you need the SRDISK.EXE.
  102.  
  103. The disk can be enabled by, for example, using command "SRDISK d: 1024"
  104. which will make disk d: a 1024K disk. It can be disabled by making it of
  105. size 0: "SRDISK d: 0".
  106.  
  107. The SRDISK is self documented. You'll get the documentation by typing at
  108. the DOS prompt "SRDISK /?" and hitting enter.
  109.  
  110.  
  111.  
  112.                 4. TECHNICAL DATA FOR FURTHER DEVELOPMENT
  113.  
  114. The job is split between the device driver and the SRDISK program this
  115. way:
  116.  
  117. Device driver does:
  118.  
  119.   * What ever a RAM disk driver is expected by the DOS to do.
  120.  
  121.   * Support IOCTL calls using the one defined data packet. The packet
  122.     contains the following data:
  123.       - BIOS parameter block for the drive.
  124.       - Disk size in K-bytes.
  125.       - Read/write access flags (read flag is actually enabled flag).
  126.       - Media byte.
  127.       - Flag to tell if the media has changed (set by SRDISK).
  128.       - Number of open files on drive.
  129.       - Pointer to the sector read/write function in the driver.
  130.       - Some information about what kind of memory can be used for the
  131.         disk.
  132.  
  133.   * Allocate, reallocate and free what ever disk memory is used by the
  134.     driver.
  135.  
  136. SRDISK does:
  137.  
  138.   * Send the driver the new disk format (with media change flag set).
  139.  
  140.   * Format the new disk i.e. write the boot sector, FAT(s) and root
  141.     directory according to the format sent to driver.
  142.  
  143. I've done it this way because I did not want to bother myself adding the
  144. SRDISK functions to the driver too. Some program was anyway needed to
  145. control the driver.
  146.  
  147. I am planning to redesign the device driver so that one can hook many
  148. device drivers all supporting different kinds of memory to one logical
  149. drive. This would remove the need for drivers that use many different
  150. kinds of memory and allow user to make driver combinations of his own.
  151.  
  152. The sources are somewhat documented.
  153.  
  154.  
  155.  
  156.                              5. LAST WORDS
  157.  
  158. Although no rights are reserved, I HOPE you will send any modified
  159. versions, new drivers, better documentation, bug reports, suggestions
  160. and your love (preferably female) to me. If I can, I'll then add them to
  161. the next release of SRDISK.
  162.  
  163. I'd like the modifications to sources as patches to some version the
  164. number of which you should tell.
  165.  
  166. Make sure every material you contribute is in public domain. I do not
  167. want to add any copyright texts to this product. While I was starting
  168. this thing, I tried to find some PD sources where to start and found
  169. none - I only got frustrated. I hope to fix that too.
  170.  
  171. I'll make a list of every people contributing material to this product
  172. and ship it with further releases. If modesty is one of your virtues, I
  173. can leave you out of the list.
  174.  
  175. You can contact me by sending E-mail from
  176.  
  177.         Internet, Bitnet etc. to 'mkohtala@niksula.hut.fi'
  178.         CompuServe to '>INTERNET:mkohtala@niksula.hut.fi'
  179.  
  180. or by calling Airline QBBS, 24H, HST, V.32, V.42, MNP, +358-0-8725380,
  181. and leaving mail to me, Marko Kohtala.
  182.